home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / tcsh6072.zip / tcsh6072 / README.OS2 < prev    next >
Text File  |  1997-06-10  |  9KB  |  201 lines
  1. This has been modified from the first version so please reread it.
  2. Please also read README.NEW.  -- CRH
  3.  
  4. This document assumes an understanding of UNIX and the UNIX and TCSH
  5. environment. If you don't know what .tcshrc is, or you HOME dir, there's
  6. going to be some trouble. 8-)
  7. ------------------------------------------------------------------------------
  8.  
  9. /*-
  10.  * Copyright (c) 1980, 1991 The Regents of the University of California.
  11.  * All rights reserved.
  12.  *
  13.  * Redistribution and use in source and binary forms, with or without
  14.  * modification, are permitted provided that the following conditions
  15.  * are met:
  16.  * 1. Redistributions of source code must retain the above copyright
  17.  *    notice, this list of conditions and the following disclaimer.
  18.  * 2. Redistributions in binary form must reproduce the above copyright
  19.  *    notice, this list of conditions and the following disclaimer in the
  20.  *    documentation and/or other materials provided with the distribution.
  21.  * 3. All advertising materials mentioning features or use of this software
  22.  *    must display the following acknowledgement:
  23.  *      This product includes software developed by the University of
  24.  *      California, Berkeley and its contributors.
  25.  * 4. Neither the name of the University nor the names of its contributors
  26.  *    may be used to endorse or promote products derived from this software
  27.  *    without specific prior written permission.
  28.  *
  29.  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  30.  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  31.  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  32.  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  33.  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  34.  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  35.  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  36.  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  37.  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  38.  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  39.  * SUCH DAMAGE.
  40.  */
  41.  
  42. The above is posted as per request of the Author.
  43. I, Charles Hunter, accept no responsibility of this software and consider
  44. myself a "contributor" in reference to the above text.
  45. ------------------------------------------------------------------------------
  46.  
  47. It's finally here! Those of you who've tried to be satisfied with Bourne shell,
  48. suffered through the Korn fields, and considered actually purchasing that
  49. commercial cshell, rejoice! TC-Shell is here!
  50.  
  51. TCSH 6.05 was originally compiled for OS/2 using the EMX 09a package, on a
  52. 386sx20 with 8 Megs of RAM. A full compile took over 4 hours each time. After
  53. more than four months of freetime, and about 72 full compiles later, not to
  54. mention countless misc compiles, tcsh is finally ready.  Please think
  55. about this a few moments when you try to fathom the amount of work put into
  56. getting this to compile. 8-)
  57.  
  58. The patched source is not included in this distribution, as it is not an
  59. official port by the Author, Christos Zoulas. Once the source has been diff'ed
  60. properly, it will be added to the next distribution. I am not contributing the
  61. source until I work out all the major bugs.
  62.  
  63. The executable will work on both FAT and HPFS based systems. The .tcshrc, .cshrc
  64. and .login files on FAT systems should be named tcsh.rc csh.rc and login.rc
  65. [ last two are a little silly but are still recognized ]
  66. It has only been tested with Warp, but I will assume 2.X compatibility
  67. until someone says otherwise.
  68.  
  69. Included are a sample termcap file, a sample .tcshrc file, the TCSH 6.07
  70. unformatted manpage, and a preformatted manpage for those without groff.
  71.  
  72. This is the fifth version of this port, and I have managed to get rid of
  73. alot of bugs and provide complete support for just about everything in OS/2.
  74.  
  75. ****** NOTE ******
  76.  
  77. ** TCSH REQUIRES the EMX 09c2 runtime files! These can be obtained by Anonymous
  78. FTP on hobbes.nmsu.edu or any of its mirrors in the directory
  79. /old/os2/unix/emx09b.
  80.  
  81. The offical manner in which to access hobbes is through the Web now, so
  82. please use http://hobbes.nmsu.edu . I am not sure where
  83. the UNIX related tools will go  when hobbes is finished restructuring.
  84.  
  85.  
  86. ** NOT included are any basic shell utilities! These can easily be obtained by
  87. Anonymous FTP on hobbes.nmsu.edu in the directory /old/os2/unix.
  88. The most common of these are: cp, mv, rm, ls, dir, mkdir, rmdir, cat, ps ...
  89. recommended programs, also include HSTART by Henk Kelder, which can be
  90. renamed to START and used exactly like in cmd.exe
  91.  
  92. * JOB CONTROL is not supported. I, along with some others, am looking
  93. into this. It seems doable, but since this is a project only for my freetime,
  94. I'm afraid it may be awhile. Remember that you can still detach processes
  95. with '&' . I have made much progress recently on "hacked" job control, and
  96. I belive the solution to this is an EMX support device driver, like
  97. the XF86sup.sys driver. Job control is certainly possible.
  98. Most of my freetime in this past year has been devoted to trying to
  99. create complete BSD job control subsystem
  100.  
  101. * some environment variables that should be set in your config.sys are:
  102. HOME, EDITOR, USER, TERMCAP, TERM etc etc...
  103.  
  104. * you must have a valid termcap data file
  105.         ( a sample one is included )
  106.  
  107.  
  108. * keep in mind that most OS/2 and DOS programs expect to do globbing
  109. themselves and *not* the shell. When you want to use a program that does this
  110. you must put \'s in front of your wildcards. eg:
  111.  
  112.         ./foo.exe \*.txt
  113.  
  114. * also path seperators are expected to be '\' by many of these same programs
  115. they must also be prefixxed with \'s. eg:
  116.  
  117.         /dos/move.exe \*.txt \\usr\\tmp\\text
  118.  
  119.  
  120. * Also note that you must add '.' to your path to get programs to run in the
  121. current directory, or to use WPS executed shellscripts that do not specify
  122. the "Working Directory" in the settings notebook of the object.
  123.  
  124. PLEASE NOTE:
  125.  
  126.         When using tcsh as your default shell, leave COMSPEC as cmd.exe
  127.         ( set only OS2_SHELL to tcsh ).
  128.  
  129.  
  130. KNOWN BUGS AND LIMITATIONS:
  131.  
  132.         Minor PATH complaints will occur if a file longer than 8.3 is
  133.         searched for ( does not exist ) and your path contains FAT drives.
  134.  
  135.         cursor problems will arise if termcap entries do not have 'pt' removed
  136.         from them. ( Truthfully, I don't think this is the best solution, but
  137.                         It works )
  138.  
  139.         Some applications that will try to switch to a fullscreen will
  140.         return an error "Cannot execute binary file"
  141.         *** IF THIS HAPPENS TO YOU, PLEASE  EMAIL ME WHAT PROGRAM DID IT  ***
  142.  
  143.         If a program that is executing cannot find one of its DLL's, TCSH
  144.         will incorrectly report "Command not found"
  145.  
  146.         When operating on a CDROM or other device that "spins down"
  147.         when idle, completion may not work the first time you hit TAB.
  148.  
  149.         If the COMSPEC environment variable is set to tcsh, .cmd files
  150.         will either report "command not found" or spin off into recursions
  151.         of tcsh. ( killable by watchcat )
  152.  
  153.         TCSH for OS/2 will not warn you of running
  154.         background processes that are spawned if you exit
  155.         the shell. They will continue to run until they have
  156.         completed and your shell will be "locked" until that point.
  157.  
  158.         currently there is no method available to the user within
  159.         TCSH to modify LIBPATH. ( sorry )
  160.  
  161.  
  162. Please send OS/2 specific TCSH questions, comments, bug reports etc, to me,
  163.  
  164.                 Charles Hunter
  165.                         crh@purdue.edu
  166.                         huntercr@cs.purdue.edu
  167.  
  168. ( or by snail mail, or phone listed below. Email preferred )
  169.  
  170. General TCSH  questions, etc... should be directed to the author,
  171.  
  172.                 Christos Zoulas
  173.                          christos@ee.cornell.edu
  174.  
  175.  
  176.  
  177. Please read the original README and README.NEW file for more information.
  178.  
  179.  
  180. This program is freeware, but is copyrighted and subject to the Regents
  181. and others. I do not speak for others, but if seeing your dreams of tcsh
  182. on OS/2 come true inspires you to give out cash freely, I will, of course,
  183. accept donations. 8-)
  184.  
  185.                         -- Charles Hunter
  186.  
  187.                                         3712 Boulder CT
  188.                                         Lafayette, IN 47905-4009
  189.                                         PH# 317-447-6013
  190.                                         EMAIL:  crh@purdue.edu
  191.                                                 huntercr@cs.purdue.edu
  192.                                                 hunter@expert.cc.purdue.edu
  193.  
  194. The complete source distribution and important documentation for tcsh 6.0.7
  195. can be obtained from many anonymous FTP sites.
  196.  
  197. A wonderful source for TCSH related tutorials documentation  etc can
  198. be found at http://night.primate.wisc.edu/software/csh-tcsh-book/
  199. links to the source can also be found here.
  200.  
  201.